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CALL BACKUP 
TABLE FILE 



1 r 


SELECT 


FILESYSTEMS 


TO 


BACKUP 



SPLIT MIRRORED 
FILESYSTEMS 



fi 



I Table file format 

I Formot: bc:pfs:plv:c:afs:aiv 

§ xb:/home:hd1 :2/alt/home:/altlvh 



exec 3<&- 



FIG. 9G 
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ijf!/bin/ksh 

§mmM§§m§mm§mmm§§§mm§m§§§§m§§§§im 

§ fscpbtab_unlock.ksh 

I Version 0.01 

I Runs various AIX connmands to rennove lock on 

I the FSCPBK table file 

i Assembled by Carl Gusler 

I IBM Global Services 

1 IBM Austin 

I cgusler@us.ibnn.com 

§ 

§ (With help from many friends) 
§ 

§ Copyright IBM 1996, 1997, 1998. 1999 

I Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, regulations, and retributions of 

§ IBM Global Services 

I Intellectual Capitol Monogement 



I Copyright Information:' Copyright IBM 1998 

I Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, and regulations of 

I IBM Global Services 

§ Intellectual Property Management 

# 

§ This program is on IBM Type II Deliverable as 
I described in the IBM Customer Agreement and 

I relevant IBM services controcts. 

§ IBM retains all rights to this program and does not 

I transfer any rights for replication or distribution 

§ of this program except for the following: 

I 1. Backup/archive copies token os a normol 

§ course of system mointenonce, 

I 2. Copying the program to a similar machine 

§ within the some enterprise. 

# 

§ The customer ogrees to restrict access to this 
I program as they would their own proprietary code, 

§ and to notify IBM should unouthorized distribution 

§ occur. 

I FIG. , 7A 
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This progrom is distributed on on *'os is" basis, 
no worronty is expressed or implied. 



Description: Removes lock on /etc/fscpbktob table file. 

A cleonup utility for problem times with FSCPBK scripts 
Operational Environment: AIX V4 
Input: 
Output: 
Return Value: 

Comments: NOTE!!: This script is an excerpt of the fscpbk_back.ksh 
script, if that script is edited, this one 
should probably be edited to match. 



§ Version History: None 



# 

§ Environments Variables 



I Constants 
bar='= = = = = 



wire= 



§ Voriables 

numeric_date=$(dote +%m%d%y) 
text_date=$(dQte +%d%b%Y) 
typeset -i return__code 
typeset -i merge_return_code 
typeset -i retoin_doys=90 
typeset -i in_retain_days 
typeset -i copies 
typeset -i ncrement 
typeset -i mount_fs_test 
invoked_nome=$0 

script_name=${invoked_namej5fj5f*/l 
user_id=$(whoami) 

desc=*ADSM Archive atttext_date FIG 7B 
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§ Process Control Variables 

Lflag=0 

L_flag=0 

r-flog=0 

d_flag=0 

§ Files 

default_log_dir=/var/odm/scriptlogs JP JQ_ 7 C 

default_log_file=$script_name.$texLdate 

default_backup_device=/dev/rmt0.1 

work_file1 =/tmp/$script_name.$text_date.work1 

work_file2=/tmp/$script_name.$text_date.work2 

conf ig_f ile= / etc/f scpbktob 

audiLfile=/etc/fscpbktab.oudit 

lock_f ile=/ vor/iocks/f scpbktob 



I Function: show_usage 

I Description: Displays comnnand usage syntox and exits 
I Input: None 

I Output: Usage message to stondord error 
I Return Value: 2 

# Note: This function does not return. It completely exits. 

I 

show_usage () 

I 

print ~u2 

print -u2 "Usage: fscpbktab_unlock.ksh [-1 directory] [-r doys] 

print -u2 " 

print -u2 " -I directory Log output directory." 

print -u2 " Default is" $default_log_dir 

print -u2 

print -u2 " -r days Log retention period." 

print -u2 " Default is" Sretain_days 

print -u2 " 
exit 2 

\ 

I 

§ 

§ Korn Shell Settings 



|set -0 errexit § Turn on error tropping and error exit mode 

|set -0 noclobber § Prevent overwriting of existing files 

|set -0 noexec § Perform syntax checking without execution 

§se[ -0 nolog § Prevents storing function defs in history file 
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jfset -0 xlroce § Turn on debug mode 



I _ 

# 

§ Main Routine 

I 

I 

§ Test for any passed porometers. 

§\i [ $? 1= 0 ] 
jjfthen 

I show_ usage 
§ 

log_dir=$default_log_dir 

jjf Parse Comnnand Line Arguments into Variables 

while getopts \:r§ c 

do 

case $c in 

I) § Set up the -I flag 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_ usage;; 
esoc 
done 

shift $((0PTIND-1)) 

jjf Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ SLflag -eq 1 ]]; then 

log_file=$in_log_dir/$default_log_file 

mkdir -p $in_log_dir 2>/dev/null jfCreote new log directory 

else 

log_file=$default_log_dir/Sdefault_log_file 

nnkdir -p $default_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_ retain_days J^JG 7 D 
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§ Cleor old logs 

find $log_dir -nome "$script_name*" -mtime $retoin_days -exec rm ||\; 
§ Create new log file 

exec 3>> $log_file § Open log file for writing 



print 


-u3 "\n 




print 


-u3 " = 




print 


-u3 " = 


Systems Management Transaction Log 


print 


-u3 " = 


n 


print 


-u3 " = 


Created by script:" $script_nanne 


print 


-u3 = 


on system:" S(hostname) 


print 


-u3 = 


at :" $(dote) 


print 


-u3 = 


» 


print 







§ Perform Work 

§ Comments: NOTE!!: This script is on excerpt of the fscpbk_back.ksh 

I script. If that script is edited, this one 

I should probobly be edited to motch. 



# Test for existing table file 
if [[ ! {-r $config_file) ]]; then 

print -u2 "Fatal Toble error. Table file" $config_file "not found." 

print -u3 "Fatal Toble error. Table file" $config_file "not found." 

exec 3<&- 

exit 99 



§ Unlock table file 

chmod 644 $config_file 
rm $lock_file 2» $log_file 

exec 3<&- 

exit 0 



fi 



FIG. 7E 



\ 
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j5(!/bin/ksh 



§ 

§ fscpbktab_build.ksh 

jjf Version 0.33 

§ Runs various AIX connnnands to build ' ■ 

§ table of filesystenas to backup 

§ Assembled by Carl Gusler 

§ IBM Global Services 

jjf IBM Austin 

jjf cgusler@us.ibnn.com 

# 

jjf (With help from many friends) 
§ 

§ Copyright IBM 1996, 1997, 1998, 1999 

I Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, regulations, and retributions of 

I IBM Global Services 

I Intellectual Capital Management 

§ 



n _ 

§ Copyright Information: Copyright IBM 1998 

§ Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, ond regulotions of 

§ IBM Globol Services 

§ Intellectuol Property Monogement 

§ 

§ This program is on IBM Type II Deliverable as 

jjf described in the IBM Customer Agreement ond 

jjf relevant IBM services contracts. 

§ 

jjf IBM retains all rights to this program and does not 

I transfer any rights for replication or distribution 

§ of this program except for the following: 

I 1. Backup/archive copies token as a normal 

jjf course of system maintenance. 

I 2. Copying the program to a similar machine 

§ within the same enterprise. FIG 8 A 

I 

§ The customer agrees to restrict access to this 

jjf program os they would their own proprietary code, 

jjf ond to notify IBM should unauthorized distribution 

§ occur. 

a 



11/51 
AT9-99-234 



§ This program is distributed on on "os is basis, 

I no warranty is expressed or innplied. 

a 

I 

I 

I 

§ Description: Builds table file for other scripts in FSCPBK package. 

I Operotional Environnnent: AIX V4 and ADSM V3.1 

§ Input: 

# Output: 

I Return Value: 

I Comments: 

§ 

n 

n 

§ 

§ Version History: None 

§ 

I 



§ Environmental Voriobles 



§ Constants 
bor='= = = = = 

wire=*= 



§ Voriobles 

numeric_dote=$(dote ■l%Y%m%d%H%M) 

text_date=$(date +%d%b%Y) 

typeset -i ret urn_ code 

typeset -i retain_days=10 

typeset -i in„retQin_days 

typeset -i copies 

typeset -i ncrement 

typeset -i return_code 

invoked_name=$0 

script_nanne=$| invoked_namejjf#»\J 
user_id=$(whoanni) 



§ Process Control Voriobles 
Lflag=0 

y^To FIG. 8B 
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§ Files 

defoult_log„dir=/var/Qdm/scriptlogs 

defoult„log_file=$script_name.$text_date 

work_filel =/tmp/$script_name.$texLdote.work1 

work_file2=/tmp/$scripLname.$text_dote.work2 

config_file=/etc/fscpbktQb 

lock„file=/var/locks/fscpbktob 



I Function: show_usage 

I Description: Displays command usage syntax ond exits 
I Input: None 

§ Output: Usage message to standard error 
If Return Value: 2 

§ Note: This function does not return. It completely exits. 



show_usage () 

I 



print -u2 
n 



pn 
pri 

pr 

pri 

pr 
pr 

pri 
pri 
ex 



n 
n 
n 
n 
n 
n 
n 
t 2 



-u2 "Usoge: fscpbktab_build.ksh [-1 directory] [-r days] 
-u2 " 

-u2 " -I directory Log output directory" 

-u2 " Default is" $defoult_log_dir 

-u2 " -r days Log retention period." 

-u2 " Default is" $retain_days 
■u2 " 



§ Korn Shell Settings 



|set -0 errexit § Turn on error trapping and error exit mode 

|set -0 noclobber § Prevent overwriting of existing files 

jjfset -0 noexec § Perform syntax checking without execution 

jifset -0 nolog § Prevents storing function defs in history file 

|set -0 xtroce § Turn on debug mode 



If 

n Moin Routine FIG. 8C 
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I Test for ony possed porometers. 

#if [ $? != 0 ] 

Ithen 

I show_usoge FIG. 8D 

log_dir=Sdefault_log_dir 

jjf Porse Command Line Arguments into Voriobles 

while getopts o:\:p:r§ c 

do 

cose $c in 

I) § Set up the -I flog 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flog 
r_flQg=1 

in_retain_doys=$OPTARG;; 
:) show_usoge;; 
\?) show_ usage;; 
esQC 
done 

shift $((0PTIND-1)) 

jjf Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ SLflag -eq 1 ]]; then 

log_file=$in_log_dir/$default_log_file 

mkdir -p $in_log_dir 2>/dev/null jjlCreote new log directory 

else 

log_file=Sdefoult_log_dir/$default_log_file 

mkdir -p $default_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retoin_days 

fi 

§ Clear old logs 

find $log_dir -name "$script_name*" -mtime $retain_days -exec rm ||\; 
§ Create new log file 

exec 3>> $log_file # Open log file for writing 
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print -u3 "\n== = = = = = = = = = === = = = = = = = = = = = 

print -u3 "= =" 

print -u3 "= Systems Monaqennent Transaction Log 

print -u3 "= =" 

print -u3 "= Greeted by script:" $script_nanne 

print -u3 "= on system:" $(hostname) 

print -u3 "= at :" ${date) 

print -u3 "= =" 

print -u3 " === = = = = ===== = = = = === = = = = = = = : 



§ Perform Work 

§ Test for locked table file and exit 
if [[ -f $lock_file ]]; then 

print -u2 "Toble file is currently in use and locked." 

print -u3 "Toble file is currently in use and locked" 

exec 3<&- 

exit 96 

fi 

§ Test for existing table file and save 
if [[ -r $config_file ]]; then 

mv $config_file $config_file.old.$text_dote 

fi 



-uJj ' =" 

-u4 "j|l Filesystem Bockup Selection Table file =" 

-u4 y = ^ 

-u4 "# Format: bc:pfs:plv:c:ofs:alv =" 
-u4 "J 

-u4 "jjf or 

-"^ "J 

-u4 "# be (Backup Control) 

-u4 § xb -> AIX Bockup (Level 0 AIX FS Bockup) =" 

-u4 "# no -> NO Backup (Skip filesystem) =" 

-u4 "# as -> ADSM Selective Bockup =" 

-u4 "§ oi -> ADSM incremental Backup =" 

-u4 "jjf 00 -> ADSM Archive 
-u4 1 

-u4 y = ^ 

-u4 *'§ pfs (Primary Filesystem) 

-u4 "§ The full path of standard filesystem =" 

"u4 "I 

-u4 "§ piv (Primary Logical Volume) =" FIG. 8E 
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print -u4 "jjf The AIX LV name of the logical volunne 

print -u4 "§ containing the primary filesystem =" 

print -u4 =" 

print -u4 c (Copies) =" 

print -u4 The number of AIX LVM copies of the =" 

print -u4 logical volume contoining primary 

print -u4 filesystem. =" 

print -u4 "§ Must be numeric 1,2. or 3. 

print -u4 **§ 

print -u4 ofs (Alternate Filesystem) =" 

print -u4 "§ The full path of mirror copy filesystem =" 

print -u4 "§ Must be unique!!!!! 

print -u4 "j|f =" 

print -u4 "§ oiv (Alternate Logical Volume) =" 

print -u4 "§ The AIX LV name of the logical volume =" 

print -u4 "jjf containing the olternate filesystem 

print -u4 "jjf Must be unique!!!!! =" 

print -u4 "jjf =" 

print -u4 "jjf Exomple for o mirrored home filesystem to be =" 

print -u4 "jj( backed up using AIX backup command: =" 

print -u4 "jjf =" 

print -u4 "jjf xb:/home:hd1:2:/alt/home:altlvh =" 

print -u4 "jjf =" 

print -u4 "jjf= ==== = = = === = === = = = = = === = = = = = = = = === = = = = = ==: 



print -u3 "\nStarting Build of Filesystem Backup Table File." 

print -u3 "\nTable lines are:" 

ncrement=0 

return_code=0 

for fs_line in $(lsfs -oc | grep -v ^jjf) 
do 

if [[ $(print $fs_line | cut -f 3 -d : ) = jfs ]]; then 
fs_prime=$(print Sfs_line | cut -f 1 -d :) 
lv_prime=$(print Sfs_line | cut -f 2 -d : | cut -c 6-) 

jjf What if LV in /etc/filesystems does not actually exist? 
§ LSLV below croaks 

copies=$(lslv $lv_prime | grep COPIES | owk '| print $2 (') 
if [[ Scopies -eq 1 ]]; then 

tab_line=xb:$fs_prime:$lv_prime:Scopies 
elif [[ Scopies -eq 2 ]]; then 

tab_line=xb:$fs_prime:$lv_prime:Scopies:/alt/fs$ncrement:altlv$ncrement 

((ncrement=$ncrement+ 1 )) 
elif [[ Scopies -eq 3 ]]; then 

tob_line=xb:$fs_prime:Slv_prime:Scopies:/alt/fs$ncrement:altlvSncrement 

((ncrement=$ncrement+1)) tpt/^ o IP 

else r ILr. \ Or 



done 
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tab_line=xb:$fs_prinne:$lv_prinie:1 

print -u2 "Script execution error: AIX Islv output confusion." 
print -u3 "Script execution error: AIX Islv output confusion" 
((return_code=$return_code+ 1 )) 

fi 

print -u3 $tob_line 
print -u4 $tab_line 

^' FIG. 8G 



exec 3<&- 
exec 4<&- 

jjf Test for filesystenn parsing problenns 
if [[ $return_code -ne 0 ]j; then 
exit 10 

fi 

exit 0 



FIG. 1 2 J 

else 

print -u3 "Files/stem" $target_fs "not mountoble. Not booked 
return_code=1 

fi 

fi 

done 



exec 3<&- 

# Test for unsuccessful filesystem merges 
if [[ $nnerge_return_code -ne 0 ]]; then 

exit 20 

fi 

xm $lock_file 2>/dev/null 
chmod 644 $config_file 

# Test for unsuccessful filesystem bockups 
if [[ $return_code -ne 0 ]]; then 

exit 10 

fi 

exit 0 
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#!/bin/ksh 



I fscpbktob_check.ksh 

§ Version 0.33 

I Runs various AIX connmonds to check filesystem 

I table file 

I Assennbled by Carl Gusler 

i IBM Globol Services 

I IBM Austin 

I cgusler@us.ibm.conn 

§ (With help from many friends) 
§ 

§ Copyright IBM 1996. 1997. 1998, 1999 

§ Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, regulotions, and retributions of 

§ IBM Global Services 

§ Intellectual Capital Management 



n 

# 

§ Copyright Information: Copyright IBM 1998 

# Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, and regulotions of 

I IBM Global Services 

§ Intellectual Property Monogement 

§ This program is on IBM Type II Deliverable as 

§ described in the IBM Customer Agreement and 

If relevont IBM services controcts. 

# 

§ IBM retains oil rights to this program and does not 

§ transfer ony rights for replication or distribution 

§ of this program except for the following: 

§ 1. Backup/archive copies token as o normol 

§ course of system maintenance. 

§ 2. Copying the progrom to o similar machine 

§ within the some enterprise. 

§ 

§ The customer agrees to restrict access to this 

I program as they would their own proprietary code. 

if and to notify IBM should unauthorized distribution 

§ occur. 

' FIG. 9A 
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This program is distributed on on "as is" basis, 
no warranty is expressed or innplied. 



.is 



Description: Performs syntax check on FSCPBK toble file. 

Port of FSCPBK packoge of scripts. 
Operational Environment: AIX V4 and ADSM V3.1 
Input: 
Output: 
Return Value: 
Comments: 



jjf Version History: None 



I Environmental Variables 



I Constants 
bor='= = === 



wire= =- 



§ Variables 

numeric_date=$(date +%m%d%y) 
text_date=$(date +%d%b%Y) 



typeset 
typeset 
typeset 
typeset 
typeset 
typeset 
typeset 
typeset 



return_code 

retain_doys=90 

in_ retain, days 

copies 

lv_copies 

lv_disks 

ncrement 



return_code J^TC^ QFi 

invoked_name=$0 r ivj^. 

script„name=$|invoked_namej|f#*/i 
user„id=$(whoami) 



I 
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§ Process Control Variables 

Lflag=0 

L_flag=0 

r_flag=0 

§ Files 

defoult_log_dir=/var/adm/scriptlogs 

defoult_log_file=$script_name.$text_date 

work_filel=/tmp/$scripLnQme.$text_date.work1 

work_file2=/tmp/$script_name.$text_date.work2 

config_file=/etc/fscpbktob 

oudiLfile= /etc/fscpbktob.oudit 

lock_file=/var/locks/fscpbktQb 

n 

§ 

§ Function: show_usQge 

I Description: Displays comnnand usage syntox and exits 

I Input: None 

§ Output: Usage message to standard error 

i Return Value: 2 

jf Note: This function does not return. It completely exits. 

I 

show_usage () 

{ 



-I directory Log output directory." 
Default is" $default_log_dir 

II 

-r days Log retention period " 
Default is" $retain_days 



print 


-u2 


prini 


-u2 


prinl 


-u2 


prinI 


-u2 


prinl 


-u2 


prinl 


-u2 


prinl 


-u2 


prinl 


-u2 


print 


-u2 


exit 


2 



I 



§ 

§ Korn Shell Settings 



FIG. 



jjfset -0 errexit § Turn on error trapping and error exit mode 

|set -0 noclobber § Prevent overwriting of existing files 

#set -o noexec § Perform syntax checking without execution 

|set -0 nolog § Prevents storing function defs in history file 

|set -0 xtrace § Turn on debug mode : 
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I Main Routine 



Test for any passed parameters, 
if [ $? != 0 ] 
en 

§ show_usage 
I 

log_dir=$defoult_log_dir 

§ Parse Command Line Arguments into Variables 

while getopts a:l:p:rj5f c 

do 

cose $c in 

I) § Set up the -I flog 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esoc 
done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 

§ Configure Logging 

if [[ $l_flog -eq 1 ]]; then 

log_file=$in„log_dir/$default_log_file 

mkdir -p $in_log_dir 2>/dev/null #Creote new log directory 

else 

log_file=$default„log_dir/$default_logfile 

mkdir -p $default_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

§ Clear old logs 

find $log_dir -nome "$script„name*" -mtime $retain_days -exec rm ||\; 

§ Create new log file ' IPTn on 

exec 3>> $log_file § Open log file for writing r ILr. C/U 
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print 


-u3 \n 




print 


-u3 " = 


II 


print 


-u3 " = 


Systenns Monogennent Tronsoction Log 


print 


-u3 " = 


II 


print 


-u3 " = 


Creoted by script:" $script_nQme 


print 


-u3 " = 


on system:" $(hostname) 


print 


-u3 " = 


at :" $(date) 


print 


-u3 " = 


II 


print 







§ Perform Work 

§ Test for existing table file 

if [[ ! (-r $config_file) ]]; then 

print -u2 "Toble error: Table file" $config_file "does not exist" 

print -u3 "Table error: Table file" $config_file "does not exist" 
exit 99 

fi 



§ Test for locked table file 

if [[ -f $lock_file ]]; then 

print -u2 "Warning: Table file is currently in use and locked" 
print -u3 "Warning: Table file is currently in use and locked." 

fi 

§ Perform Syntax Checking on Toble File 
return_code=0 
ncrement=1 

for fs_line in S(cat $config_file | grep -v 
do 

action=$(print $fs_line | cut -f 1 -d :) 
cose Section in 

xb) : 

no) ; 

as) : 

Qi) : 

oo) : 

♦) print -u2 "Table error: Action" Jaction "not valid." 
print -u3 "Table error: Action" Section "not valid." 
((return_code=Sreturn_code+ 1 ));; 

esac 

fs_prime=S{pnnt Sfs_line | cut -f 2 -d :) 
lv_prime=$(print Sfs_line | cut -f 3 -d :) 

if [[ S(lsfs -c Sfs_prime | grep Slv_prime | wc -I) -ne 1 ]]; then 

print -u2 "Table error: Filesystem" $fs_ prime "does not reside in LV Slv_prime 
print -u3 "Table error: Filesystem" $fs_prime "does not reside in LV Slv_prime 
((return_code=$retum_code+ 1 )) 

copies=S(print Sfs_line | cut -f 4 -d :) . ^ ^ ^' 
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if [[ (Scopies -ge 1) && ($copies -le 3) ]]; then jpTr^ o zt' 

if [[ (Scopies -gt 1) kk (Scopies -le 3) ]]; then F iLr. tfr 

fs_olt=S(print $fs.line | cut -f 5 -d :) . ... 

lv_alt=$(print $fs_line | cut -f 6 -d :) 
if [[ $(lsfs -c $fs_alt 2>/dev/null | wc -I) -ne 0 ]]; then 
print -u2 "Table error: Filesystenn" $fs_alt "already exists." 
print -u3 "Toble error: Filesystem" $fs_alt "alreody exists." 
((return_code=$return_code+ 1 )) 

fi 

if [[ $(lslv $lv_alt 2>/dev/null | wc -I) -ne 0 ]]; then 
print -u2 "Toble error: LV" $lv_alt "already exists" 
print -u3 "Table error: LV" $lv_alt "already exists." 
((return_code=$return_code+ 1 )) 

fi 

strictness_flag=$(lslv $lv_prime | grep "EACH LP COPY ON" | grep yes | wc -I) 

if [[ Sstrictness„flag -eq 0 ]]; then 

print -u2 "LVM Warning: Mirror strictness not set for LV" $lv_prime 
print -u3 "LVM Warning: Mirror strictness not set for LV" $lv_prime 

fi ; 

lv_copies=$(lslv $lv_prime | grep COPIES | owk'j print $2 \') 

if [[ $lv_copies -rie Scopies ]]; then 

print -u2 "LVM Warning: LV nnirroring does not nnatch table for LV" $lv_prinne 
print -u3 "LVM Warning: LV mirroring does not match table for LV" $lv_prime 

fi 

lv_disks=$(lslv -I $lv_prime | grep hdisk | wc -I) 

if [[ $lv_disks -ne $lv_copies ]]; then 

print -u2 "LVM Warning: Brood LV mirroring distribution for LV" $lv_prime: 
print -u3 "LVM Warning: Brood LV mirroring distribution for LV" $lv_prime 

fi 

fi 

else 

print -u2 "Toble error: Invalid number of LV copies for LV" $lv_prime 
print -u3 "Toble error: involid number of LV copies for LV" Slv_prime 
((return_code=$return_code+ 1 )) 

fi 

done 

if [[ ($return_code -ne 0) ]];then 

return 98 
else 

print -u2 "Table file parses okay." 
exec 4> $audit_file § Open audit file for writing 
current_Y=$(date +%Y) 
current, m =$(date +%m) 
current_d=$(date +%d) 
current_H =$(date +%H) 
current_M=$(date +%M) 
§ print -u4 Scurrent_Y $current_m $current_d $current_H $current_M 

print -u4 ScurrenLY$current„m$current_d$current_H$current_M 

exec 4<&- 



23/51 
AT9-99-234 



#!/bin/l<sh 



§ 

§ fscpb_sync.ksh 

§ Version 0.02 

§ Runs various AIX commands to synchronize all 

§ stole logical volumes 

§ Assembled by Corl Gusler 

§ IBM Global Services 

§ IBM Austin 

§ cgusler@us.ibm.com 

§ 

§ (With help from many friends) 

I Copyright IBM 1996. 1997. 1998, 1999 

§ Controlled Distribution 

§ Protected under the procedures, processes, rights 

§ rules, regulations, and retributions of 

§ IBM Global Services 

§ Intellectual Capitol Management 



I Copyright Information: Copyright IBM 1998 

I Controlled Distribution 

I Protected under the procedures, processes, rights 

I rules, and regulations of 

I IBM Global Services 

§ Intellectual Property Management 

#. 

§ This program is on IBM Type II Deliverable as 

'§ described in the IBM Customer Agreement ond 

§ relevant IBM services contracts. 

§ 

§ IBM retains oil rights to this program ond does not 

I transfer any rights for replication or distribution 

§ of this program except for the following: 
I 1. Backup/archive copies token as a normal 

§ course of system mointenonce. 

§ 2. Copying the program to a similar machine 

§ within the some enterprise. 

§ 

§ The customer agrees to restrict access to this 

§ progrom as they would their own proprietary code. 

§ and to notify IBM should unauthorized distribution 

§ occur. 

I i .. FIG. 10A 
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§ This program is distributed on on "os is" basis, 

If no warranty is expressed or implied. 

§ 

I 

I 

# 

# Description: Synchronizes oil logical volumes with stole partitions 
I Port of FSCPBK pockoge. 

I Operotionol Environment: AIX V4 

I Input: 

I Output: 

# Return Value: 
I Comments: 

I 
§ 

I 

I 

# Version History: None 

I 

I _ 



§ Environmental Variables 



I Constonts 

bar='= = ===== = = === = = = ==== ==== = = === = = = = === === = === = = = = 

wire='= ' 

§ Variables 

numeric_date=$(date +%m%d%y) 
text_date=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i retoin_days=90 
typeset -i in_retain_days 
typeset -i copies 
typeset -i ncrement 

typeset -i return_code FIG. 1 OB 

invoked_name=$0 

script_name=$|invoked_namei|fj5f*/i 
user_id=$(whoami) 
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§ Process Control Voriobles 

Lflag=0 

L_flog=0 

r_flog=0 

§ '"'les „ 

FIG. 1 

default_log_dir=/vor/odm/scriptlogs 
defoult_log_file=$script_name.$text_dote 
work_file1 =/tmp/$scripLname.$text_dQte.work1 
work_file2=/tmp/$script_name.$text_date.work2 
config_file=/etc/fscpbktQb 



I 

# Function: show_usoge 

I Description: Disploys connnnond usoge syntax ond exits 

I Input: None 

I Output: Usage message to standard error 

I Return Value: 2 

I Note: This function does not return, it connpletely exits. 



show_ usoge 


1 




print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


exit 2 



-I directory Log output directory." 

Defoult is $default_log_dir 

ft 

-r days Log retention period." 
Default is" $retain_days 



Korn Shell Shell Settings 



|set -0 errexit j|fTurn on error tropping and error exit mode 

#set -0 noclobber § Prevent overwriting of existing files 

|set -0 noexec # Perform syntax checking without execution 

jjfset -0 nolog # Prevents storing function defs in history file 

|set -0 xtroce | Turn on debug mode 
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§ Main Routine 



I Test for any passed porometers. 

#if [ $? != 0 ] 

ithen 

I show_usage 
log_dir=$default_log_dir 

§ Parse Command Line Arguments into Variables 

while getopts l:r# c 

do 

case $c in 

I) § Set up the -I flog 
Lflag=1 

log_dir=$OPTARG;; FIG. 1 OD 

r) # Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_ usage;; 
esac 
done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ SLflog -eq 1 ]]; then 

log„file=$in_log_dir/$default_log_file 

mkdir -p $in_log_dir 2>/dev/null jffCreate new log directory 

else 

log_file=$default_log_dir/$defoult_log_file 

mkdir -p $defoult_log_dir 2>/dev/null # Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

# Clear old logs 

find $log_dir -name "$script_name*" -mtime $retain_days -exec rm )|\; 
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§ Creote new log file 

exec 3>> $log_file § Open log file for writing 



print 


-u3 " 


print 


-u3 " 


print 


-u3 " 


print 


-u3 " 


print 


-u3 " 


print 


-u3 '■ 


print 


-u3 " 


print 


-u3 " 


print 


-u3 " 



\n= 



= Systems Monogement Tronsoction Log 

» 

= Creoted by script" $script_nome 
= on system:" $(hostname) 

at :" $(date) 



§ Perform Work 

§ Test for any stole logical volumes within active volume groups 

print -u1 "Starting syncvg operation. This moke take several minutes." 
return_code=0 

for logicaLvolume in $(lsvg -o | Isvg -il | grep stale | awk'j print $1 j') 
do 

print -u3 " Starting syncvg operation on LV„ SlogicoLvolume 
print -u1 "Storting syncvg operotion on LV^^ SlogicoLvolume 
syncvg -I SlogicoLvolume 
((return_code=$return_code+$?)) 

print -u5 " Completed syncvg operation on LV SlogicoLvolume 
print -u5 " Cumulated return code is" SreturnJ!code 
done 

exec 3<&- 

if [[ (Sreturn_code -ne 0) ]];then 
return 50 

fi 



exit 0 



FIG. 10E 
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#!/bin/ksh 



§ 

§ fscpb_select.ksh 

I Version 0.34 



Runs various AIX commonds to select ond split 

filesystems for backup 
Assembled by Corl Gusler 

IBM Global Services 

IBM Austin 

cgusler@us.ibnn, com 

(With help from many friends) 

Copyright IBM 1996. 1997. 1998, 1999 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capitol Monogement 



Copyright Information: Copyright IBM 1998 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectuol Property Management 

This program is on IBM Type 11 Deliverable as 
described in the IBM Customer Agreement and 
relevant IBM services contracts. 

IBM retains all rights to this progrom and does not 
transfer any rights for replication or distribution 
of this program except for the following: 

1. Bockup/orchive copies token as o normal 
course of system maintenance. 

2. Copying the program to a similar machine 
within the same enterprise. 

The customer agrees to restrict access to this 
program as they would their own proprietary code, 
and to notify IBM should unauthorized distribution 
occur. 



FIG.: 11 A 
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This program is distributed on on "as is" basis, 
no warranty is expressed or innplied. 



Description: Selects and splits filesystems for backup. 

Part of FSCPBK package of scripts. 
Operationol Environment: AIX V4 
Input: 
Output: 
Return Value: 
Comments: 



I Version History: None 

n 

^ 

§ Environmental Variables 

n 

§ Constonts 

bar='== ===== ======= === = 

wire='= 

§ Variables 

numeric_date=$(date +%m%d%y) 
text_date=$(date +%d%b%Y) 



typeset 
typeset 
typeset 
typeset 
typeset 
typeset 
typeset 
typeset 
# typeset - 
I typeset - 
I typeset - 
I typeset - 



return_code 

retain_dQys=90 

in_retain_days 

copies 

new_copies 

ncrement 

ntest 

return, code 
edit_year 
edit_ month 
edit_day 
edit_hour 



FIG., 11 B 



30/51 
AT9-99-234 



^typeset -i ediLminute 
typeset -i edit_stomp 
typeset -i oudit_year 
typeset -i oudit_month 
typeset -i audit_doy 
typeset -i oudit_hour 
typeset -i audit_minute 
typeset -i audit_stQmp 
invoked_nQme=$0 

script_nQme=$|invoked_namejjf#*/i 
user_id=$(whoami) 



§ Process Control Voriobles 
Lflag=0 

L_flQg=0 prr 1 1 n 

r_flag=0 r Ikj^. 11^ 

o_flag=0 

I Files , ^ 

default. log_dir=/var/adm/scriptlogs 
defaults log_file=Sscript_name.Stext_date 
work_file1 =/tmp/$script_nQme.$text_date.work1 
work_file2=/tmp/$script_name.$text_date.work2 
conf ig_ f ile = / etc/f scpbkto b 
audit_file=/etc/fscpbktab.audit 
lock_file=/var/locks/fscpbktab 



I Function: show_usage 

I Description: Displays connnnand usage syntox and exits 
I Input: None 

I Output: Usage message to standard error 
I Return Value: 2 

I Note: This function does not return. It connpletely exits. 



show_usage () 

\ 

print -u2 

print -u2 "Usage: fscpbk_select.ksh -o [-1 directory] [-r doys] 

print -u2 

print -u2 " -o Override active volume protection" 

print -u2 " WARNING!!: Data integrity risk." 

print -u2 " IBM not responsible for" 

print -u2 " loss of data or integrity" 

print -u2 " if override used to split" 
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prini 


-u2 


II 




prini 


-u2 


M 




prinI 


-u2 


H 


» 


prinI 


-uz 


» 


1 


print 


-u2 


It 




prini 


-u2 


» 


n 


prini 


-u2 


II 


-r 


print 


-u2 


tl 




prini 


-u2 


II 


n 


exit 


2 







Q mirrored filesystenn" 
that is mounted!" 



Defoult is" $defoult_log„dir 

Log retention period" 
Defoult is" $retoin_days 



I Korn Shell Settings 



|set -0 errexit , § Turn on error trapping ond error exit mode 

|set -0 noclobber § Prevent overwriting of existing files 

|set -0 noexec § Perform syntox checking without execution 

|set -0 nolog § Prevents storing function defs in history file 

|set -0 xtroce | Turn on debug mode 



I Moin Routine 



I Test for any possed poromoters, 

|if [ $? != 0 ] 

Ithen 

I show_usoge 



log_dir=$defoult_log_dir 

§ Parse Command Line Arguments into Voriobles 

while getopts olrrjjl c 

do 

cose $c in 

0) § Set up the -o flog 
o_flog=1;; 

1) § Set up the -I flog 

l_flag=1 

log_dir=SOPTARG;: 
r) § Set up the -r flog 
r_flag=1 

in_retain_doys=$OPTARG;; 
:) show_usage;; 

\?) show_ usage;; FIG. 1 1 D 
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esac 
done 

shift ${(0PTIND-1)) 

§ Deol with invocotion errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 

if [[ $o_flog -ne 1 ]]; then 
show„ usage 

fi 



§ Configure Logging 
if [[ $Lflog -eq 1 ]]; then 

log_ f ile=$in_ log_dir/$default_ log_f ile 

nnkdir -p Sin_log_clir 2>/dev/null j|fCreate new log directory 

else 

log_file=$default_log_dir/$defaulLlog_file 

nnkdir -p Sdefault_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_doys = Sin_ retoin_ doys 

fi 

§ Cleor old logs 

find $log_dir -nonne "$script_nanne*" -mtime $retain_days -exec rm||\; 
jjf Create new log file 

exec 3>> $log_file § Open log file for writing 



print 


-u3 \n 




print 


-u3 " = 




print 


-u3 " = 


Systenns Management Transaction Log =" 


print 


-u3 


II 


print 


-u3 " = 


Creoted by script:" $script_nome 


print 


-u3 " = 


on systenn:" $(hostnome) 


print 


-u3 " = 


at :"$(dote) 


print 


-u3 " = 




print 


-u3 





§ Perfornn Work 



§ Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found." 



FIG. 1 1 E 
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print -u3 "Fatol Table error. Table file" $config_file "not found." 
exec 3<&- 
exit 99 

fi 

§ Test for existing table audit file 
if [[ ! (-r SoudiLfile) ]]; then 

print -u2 "Fatal Table error. Table file check progrom must be run. 

print -u3 "Fatal Table error. Table oudit file" Soudit_file "not found. 

exec 3<&- 

exit 97 

fi 

§ Test for table file audit indicating syntax check since last edit 



current_Y=$(date +%Y) 

audit_stamp=$( heod -1 $audit_file | awk '\ print $1 j') 

§ Check for colon and thus tinne instead of year on file dotestannp 
ntest=$(ls -I Sconfiafile | awk'{ print $8 |* | grep : | wc -I) 
if [[ Sntest -eq 1 ]]; then 
edit_year=$current_Y 

else 

edit_year=$(ls -I $config_file | awk'j print $8 \') 

fi 



edit_month_text=$(ls -I $config_file | awk '| print $6 j') 
edit_day=$(ls -I $config_file | awk ') print $7 |*) 
edit_hour=$(ls -I $config_file | awk '| print $8 j' | cut -f 1 -d :) 
edit_minute=$(ls -I $config_file | awk '\ print $8 {' | cut -f 2 -d :) 

§ Deternnine month number from month nome 

case $edit_month_text in 

Jon) edit_month=01;; 

Feb) edit_month=02;; 

Mar) edit_month=03;; 

Apr) edit_month=04;; 

May) edit_month=05;; 

Jun) edit_month=06;; i 

Jul) edit_month=07;; 

Aug) edit^month=08;; FIG 1 1 F 

Sep) edit_month=09;; 

Oct) edit_month=10;; 

Nov) edit_month=1 1;; 

Dec) edit_month=12;; 
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*) print -u2 "Fatal Table error. Table file date read error." 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 



edit_stanap=$edit_yeor$edit_month$edit_day$edit_hour$edit„nninute 

§ Test for table file audited since last editing 
if [[ $audit_stannp -le $edit„stamp ]]; then 

print -u2 "Fatal Toble error. Table file edited since lost checked." 

print -u3 "Fatal Table error. Table file edited since lost checked." 

exec 3<&- 

exit 97 



§ Test for locked table file and exit 
if [[ -f $lock_file ]]; then 

print -u2 "Toble file is currently in use and locked." 

print -u3 "Table file is currently in use and locked." 

exec 3<&- 

exit 96 



§ Table file format 

I Formot: bc:pfs:plv:c:ofs:alv = 
jjf xb:/home:hd1:2:/alt/home:/altlvh 

§ Create lock on table file to indicate that toble is in use. 
touch $lock_file 
chmod 000 $config_file 

§ Increment through table file and split mirrored filesystems 

return_code=0 

ncrement=0 

for fs_line in S(cat $config_file | grep -v 
do 

action=$(print $fs_line | cut -f 1 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
if [[ (Scopies -gt 1) && ($action != no) ]]; then 
fs_prime=$(print $fs_line | cut -f 2 -d :) 
lv_prime=$(print $fs_line | cut -f 3 -d :) 
fs_oit=$(print $fs_line | cut -f 5 -d :) 
lv_alt=$(print Sfs_line cut -f 6 -d :) 
tog_file=$fs_prime/.fscpbk_$lv_prime 
exec 4> $tag_file § Open tog file for overwriting 



esoc 



fi 



fi 



FIG. 11 G 
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pr 

pri 
pri 
pri 
pri 
pri 

pr 

pri 

pri 
pr 



-u4 
-u4 
-u4 
-u4 
■u4 
■u4 
■u4 
-u4 
-u4 
-u4 



f= Tog file used by IBM FSCPBK Utility. 

f= DO NOT DELETE THIS FILE!!!!!!!!!!!!!!! 

'f= 

1= Files in this directory and subdirectories below 
1= were originally contained within filesystem: 
1= " $fs_ prime 



fi 

done 



exec 4<&- 

((new_copies=$copies- 1 )) 
sync;sync 

split_fs_copy.ksh -f $fs_prime -n $fs_alt -y $lv_alt -c $new_copies -o 
((return. code=$return_code+$?)) 

print -u3 Section $fs_prime $lv_prime $copies $fs_alt $lv_alt 



exec 3<&- 

if [[ ($return_code -ne 0) ]];then 
exit 10 

else 
exit 0 

fi 



FIG. 1 1H 
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jj'l/bin/ksh 



§ 

§ fscpb_bock.ksh 

§ Version 0.34 

§ Runs various AIX commends to backup and merge 

§ filesystems 

I Assembled by Corl Gusler 

I IBM Globol Services 

I IBM Austin 

§ cgusler@us.ibm.com 

§ (With help from many friends) 
« 

§ Copyright IBM 1996,1997. 1998. 1999 

§ Controlled Distribution 

§ Protected under the procedures, processes, rights 

§ rules, regulations, end retributions of 

§ IBM Global Services 

§ intellectuol Capitol Management 



Copyright Information: Copyright IBM 1998 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectual Property Management 

This program is on IBM Type II Deliverable as 
described in the IBM Customer Agreement and 
relevant IBM services contracts, 

IBM retains all rights to this program and does not 
transfer any rights for replication or distribution 
of this program except for the following: 

1. Backup/archive copies taken as a normal 
course of system maintenance. 

2. Copying the program to a similar machine 
within the some enterprise. 

The customer agrees to restrict access to this 
program as they would their own proprietary code, 
and to notify IBM should unouthorized distribution 
occur. 

FIG. 1 2 A 
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§ This progrom is distributed on on "os is" basis, 

I no warranty is expressed or innplied. 

I 

I 



I Description: Provides capability to perform split nnirror backups. 

I Part of FSCPBK pockoge. 

I Operational Environment: AIX V4 and ADSM V3.1 

I Input: 

I Output: 

I Return Value: 

I Comments: 



I Version History: None 
I 

I 

I 

I 

§ Environmental Variables 



I Constonts 
bQr='== = = = 

wire='= 



§ Voriobles 

nunneric_date=$(dote +%m%d%y) 
texLdate=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i merge_return_code 
typeset -i retain_days=90 
typeset -i in_retain_days 

typeset -i copies FIG. 1 2B 

typeset -i ncrennent 
typeset -i mount_fs_test 
invoked_name=$0 

script_nonne=$|invoked_nonneijf#*/i 

user_id=$(whoanni) 

desc='ADSM Archive at '$text_date 

level=0 

use_tope=0 
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§ Process Control Variables 

Lflag=0 

L.flog=0 

r_flag=0 

d_flag=0 

§ Files 

. defoult_log_dir=/var/Qdm/scriptlogs 
defoulLlog_file=$script_name.$text_dQte 
default, backup. device=/dev/rmt0.1 
work_file1 =/tmp/$script_name.Stext_date.work1 
work_file2=/tmp/$script_name.$text_dote.work2 
config_file=/etc/fscpbktob 
audit_file=/etc/fscpbktab.audit 
lock_file=/var/locks/fscpbktob 



I Function: show_usage 

I Description: Displays connnnand usage syntax and exits 
j|f Input: None 

I Output: Usage message to standard error 
I Return Value: 2 

I Note: This function does not return. It completely exits. 



show_ usage () 

I 



pri 

pr 
pr 
pr 

pri 
pr 
pri 
pri 
pri 
pri 
pr 

pr 
ex 



nt -u2 " 

nt -u2 "Usage: fscpbk_ock.ksh [-d device] [-1 directory] [-r doys]" 

nt -u2 " 

nt -u2 " -d device Backup output device." 

nt -u2 " Default is" $default_backup_device 

nt -u2 

nt -u2 " -I directory Log output directory." 

nt -u2 " Default is" $default_log_dir 

nt -u2 

nt -u2 " -r days Log retention period." 

nt -u2 " Default is" $retain_days 

nt -u2 
t 2 



FIG. 12C 
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§ Korn Shell Settings 



|set -0 errexit § Turn on error tropping ond error exit mode 

|set -0 noclobber § Prevent overwriting of existing files 

|set -0 noexec § Perfornn syntax checking without execution 

|set -0 nolog § Prevents storing function defs in history file 

|set -0 xtroce § Turn on debug mode 



§ Moin Routine 



I Test for any passed parameters. 

#if [ $? != 0 ] 
Ithen 

I show_usage 
I 

log_dir=$default_log_dir 

§ Porse Commond Line Arguments into Voriobles 

while getopts d:l:rj5' c 

do 

cose $c in 

d) I Set up the -d flag 
d_flog=1 

in_ backup, device = $OPTARG; ; 
1) jff Set up the -I flog 
l_flog=1 

log_dir=$OPTARG:; 
r) § Set up the -r flog 
r_f!ag=1 

in_retQin_days=$OPTARG;; 
:) show_usage;; 
\?) show_usoge;; 
esoc 
done 

shift $((0PTIND-1)) 

jjf Deal with invocotion errors 

if [[ $user_id ! = root ]] then FIG. 1 2D 

show_ usage 

fi 

jjf Locate torget file or device for backup imoges 
if [[ $d_flag -eq 1 ]]; then 
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if [[ $in_bockup_ device = /dev/rmt[0-9]* ]]; then § Test if torget is tape drive 
use tope=1 ' V . ; 'X 

if [[ -c tin bockup device ]]; then § Test if tope drive exists 
device=$in_backup_device 

else 

print -u2 "\nNonexistent tope drive" $in_backup_device 
show-Usage 

fi 

else § Should we check to nncke sure some disk device not chosen? 
device=$ in_backup_device 

fi 

else 

device=$default_bockup_device 

fi 



§ Configure Logging 

if [[ $1 - flog -eq 1 ]]; then 

log_f ile=$in_log_dir/$def oult_log_f ile 

mkdir -p $in_log_clir 2>/dev/null jjfCreote new log directory 

else 

log_file=$default_log_dir/$default_log_file 

nnkdir -p $default_log_dir 2>/dev/null jjf Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 

retain_days=$in_retain_days 

fi 

§ Cleor old logs 

find $log_dir -nonne "$script_nonne*" -mtime $retoin_days -exec rnn {|\; 
§ Create new log file 

exec 3>> $log_file § Open log file for writing 

print -u3 "\n= = = = = = = ===== = = = = ===== = = = === === = = = = = = = = = = = = 

print -u3 "= =" 

print -u3 "= Systenns Monogenrient Transaction Log =" 

print -u3 "= =" 

print -u3 "= Creoted by script:" $script_name 

print -u3 "= on systenn:" $(hostnanne) 

print -u3 "= at :" $(date) 

print -u3 "= =" 

print -u3 "==== = = = ==== = = = = = = = = = = === = === = = = = = = = = = = = = = = = 



FIG. 1 2E 
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§ Perform Work ' .,; : - 

§ Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fotol Toble error. Toble file" $config_file "not found." 

print -u3 "Fatal Table error. Table file" $config_file "not found." 

exec 3<&- 

exit 99 

fi 

§ Test for existing table oudit file 
if [[! (-r $audit_file) ]]; then 

print -u2 "Fatal Table error. Toble file check progronn nnust be run." 

print -u3 "Fatal Table error. Table audit file" $audit_file "not found." 

exec 3<&- 

exit 97 

fi 

§ Test for table file audit indicating syntax check since last edit 



current. Y=$(date +%Y) 

audit_stonnp=$( head -1 $oudiLfile | awk 'j print Si j") 

§ Check for colon and thus tinne instead of year on file dotestomp 
ntest=$(ls -I $config_file | awk 'j print $8 |' | grep : | wc -I) 
if [[ $ntest -eq 1 ]]; then 
edit_year=$current_Y 

else 

edit_yeor=$(ls -I $config_file | owk '| print $8 |') 

fi 



ediLmonth_text=$(ls -I $config_file | owk '| print $6 |') 
editlday=$(ls -I $config_file | owk 'j print $7 |') 
edit_hour=$(ls -I $config_file | awk '| print $8 (' | cut -f 1 -d :) 
edit_minute=$(ls -I $config_file | owk 'j print S8 j' | cut -f 2 -d :) 

§ Determine month number from month name 
cose $edit_month_text in 
Jon) edit_month=01;; 
Feb) edit_month=02;; 
Mar) edit_month=03;; 

Apr) edit_month=04;; /T'/'/^ 1 PP 

May) edit_month=05;; l l^. i <.l 

Jun) edit_month=06;; 
Jul) edit_month=07;; 
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Aug) edit_month=08;; 
Sep) edit_nnonth=09;; 
Oct) edit_month=10;; 



Nov) edit_month=1 1;; 
Dec) edit_month=12;; 

*) print -u2 "Fatal Table error. Toble file date read error." 
print -u3 "Fatal Toble error. Table file date read error." 
exec 3<&- 
exit 98;; 



edit_stannp=$edit_year$edit_nnonth$edit_day$edit_hour$edit_minute 

jjf Test for toble file audited since last editing 
if [[ $audit_stannp -le Sedit_stamp ]]; then 

print -u2 "Fatal Table error. Table file edited since lost checked." 

print -u3 "Fatal Table error. Table file edited since lost checked." 

exec 3<&- 

exit 97 

fi 



jjf Table file fornnot 

§ Fornnat: bc:pfs:plv:c:afs:alv = 
I xb:/home:hd1:2:/alt/home:/oltlvh 

ncrement=0 
return. code=0 

§ Cycle through filesystenns and mount unnnounted ones 

for fs_line in $(cat $config_file | grep -v ^fj) 

do 

action=$(print Sfs_line | cut -f 1 -d :) 
fs_prime=$(print $fs_line cut -f 2 -d :) 
lv_prinne=$(print $fs_line cut -f 3 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
target_fs=$fs_prime 



esoc 




if [[ Scopies -gt 1 ]]; then 

target_fs= ${print $fs_line I cut -f 5 -d :) 

fi 



FIG. 12G 
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§ Check to see if target filesystem is mounted r ^j:;. 

mount_fs_test=$(mount | grep "$target_fs | wc -I) 
I If not mounted, mount os reodonly for backups 
if [[ $mount_fs_test -ne 1 ]]; then 

mount -o ro $target_fs »$log_file 2>>$log_file 
return_code=$? 
§ Test for unsuccessful reodonly filesystem mount 

if [[ $return_code -ne 0 ]]; then 
§ If still unsuccessful, then perform filesystem check (presume dirty superblock) 
print -u3 "Performing fsck on filesystem" $target_fs 
fsck -p Starget_fs »$log_file 2>>Slogfile 
mount -o ro Starget_fs 2>>$log_file 

fi 

fi 

fi 

done 

return_code=0 
merge_return_code=0 

§ Put Table File at start of tope to serve as tope TOC 
if [[ $use_tape -eq 1 ]]; then 
cp /etc/fscpbktob . 

echo "./fscpbktob"! bockup -ipqf Sdevice 
rm ./fscpbktob 



jjf Cycle through filesystems and perform backups and merges 

for fs_line in $(cat Sconfig_file | grep -v 

do 

action=$(print $fs_line | cut -f 1 -d :) 
fs„prime=$(print $fs_line | cut -f 2 -d :) 
lv_prime=S(print $fs_line | cut -f 3 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
torget_fs=$fs_prime 

print -u3 {action $fs_prime $lv_prime Scopies 
if [[ Soction != no ]]; then 
§ Select to bockup. alternate mirror fs if mirroring on 

if [[ Scopies -gt 1 ]]; then 

fs_alt=$(print $fs_line cut -f 5 -d :) 
lv_alt=$(print $fs_line cut -f 6 -d :) 
target_fs=$fs_alt 

print -u3 Section $fs_prime $lv_prime Scopies $fs_alt $lv_alt 

fi 



FIG. 12H 
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mount_fs_test=$(mount | grep "$targeLfs" | wc -I) j.*- ; - 

§ Test for filesystem STILL not mounted 
if [[ $mount_fs_test -eq 1 ]]; then 
cose Section in 

no) § Perform no backup action 

print -u3 "No backup performed on filesystem" Starget_fs;; 
xb) § Perform AIX Level 0 filesystem bockup 

print -u3 "Storting AIX Level 0 backup on filesystem" $target_fs "at" $(date) 

backup -$level -u -f $device $target_fs 

return_code=Sreturn_code+$? 

print -u3 "Completed AIX Level 0 backup on filesystem" $target_fs "ot" $(dote);; 
as) § Perform ADSM Selective filesystem backup 

print -u3 "Starting ADSM Selective backup on filesystem" $target_fs "at" $(date) 
dsmc sel "$target_fs/*" >$work_file1 
return_code=$return_code+$? 
cat $work_file1 »$log_file 

print -u3 "\n " 

print -u3 "Completed ADSM Selective backup on filesystem" $target_fs "at" S(date);; 
oi) § Perform ADSM Incremental filesystem bockup 

print -u3 "Starting ADSM Incremental bockup on filesystem" $target_fs "at" $(date) 
dsmc i $target_fs >$work_file1 
return_code=$return code+$? 
cat $work_file1 >>$log_file 

print -u3 "\n " 

print -u3 "Completed ADSM Incremental backup on filesystem" $torget_fs_prime "at" 
S(date);; 

oo) § Perform ADSM Archive filesystem archive 

print -u3 "Starting ADSM Archive on filesystem" $target_fs "ot" $(date) 
dsmc archive $target_fs/ -des="$desc" >$work_file1 
return„code=$return_code+$? 
cot $work_file1 >>$log_file 

print -u3 "\n " 

print -u3 "Completed ADSM Archive on filesystem" $target_fs "at" $(date);; 

esoc 

§ Merge split filesystems if mirrored 

I NOTE!!: This section is duplicated in the fscpbk_merge.ksh 
I script. Any changes anywhere in this script should 

I probably be duplicated in that script! 

I 

if [[ $copies -gt 1 ]]; then 

merge_fs_copy.ksh -p $fs_prime -s $fs_alt 
§ merge_return_code=$merge_return_code+$? 

§ fs_alt=$(prinl $fs_line | cut -f 5 -d :) FIG. 1 21 

§ lv_alt=$(print $fs_line | cut 6 -d :) 

§ target_fs=$fs_olt 
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#!/bin/ksh 



§ fscpb_merge.ksh 

I Version 0.01 

I Runs various AIX commands to nnerge 

§ filesystems 

§ Assembled by Carl Gusler 

I IBM Global Services 

I IBM Austin 

jjf cgusler@us.ibm.com 

# 

jjf (With help from many friends) 

§ 

ft Copyright IBM 1996, 1997. 1998. 1999 

§ Controlled Distribution 

§ Protected under the procedures, processes, rights 

§ rules, regulations, and retributions of 

jjf IBM Global Services 

§ Intellectual Capitol Management 



I Copyright Information: Copyright IBM 1998 

I Controlled Distribution 

§ Protected under the procedures, processes, rights 

I rules, and regulations of 

§ IBM Global Services 

I intellectual Property Management 

§ 

§ This program is on IBM Type II Deliverable as 

I described in the IBM Customer Agreement and 

§ relevant IBM services contracts. 

§ 

§ IBM retains oil rights to this program and does not 

§ tronsfer any rights for replication or distribution 

I of this progrom except for the following: 

I 1. Backup/archive copies token as a normol 

§ course of system mointenonce. 

§ 2. Copying the program to a similar machine 

§ within the same enterprise. 

§ 

§ The customer agrees to restrict access, to this 

§ program as they would their own proprietary code, 

§ and to notify IBM should unauthorized distribution 

* FIG. 13A 
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This program is distributed on on "os is" basis, 
no worronty is expressed or implied. 



I Description: Remerges filesystems split from mirrored LVs. 

I A cleanup utility for problem times with FSCPBK scripts 

I Operational Environment: AIX V4 

j Input: 

I Output: 

I Return Value: 

I Comments: NOTE!!: This script is on excerpt of the fscpbk_back.ksh 
§ script. If that script is edited, this one 

I should probably be edited to match. 

# _ 



I 

§ Version History: None 



If Environmental Voriobles 

§- — 

§ Constants 

bar='= = = === = = = = ===: 



wire= =■ 



§ Voriobles 

numeric_date=$(date +%m%d%y) 
text_dote=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i merge_return_code 
typeset -i retain_dQys=90 
typeset -i in_ retain. days 
typeset -i copies 
typeset -i ncrement 
typeset -i mount_fs_test 
invoked_name=$0 

script_name=$ |invoked_name#j|f*/i 
user_id=S{whoami) 

desc='ADSM Archive at'$text_date F/Q 1 3B 
level=0 
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§ Process Control Voriobles 

Lflog=0 

LflQg=0 

r_flag=0 

d„flag=0 

§ Files 

defQult_log_dir=/vor/adm/scriptlogs 

defaulLlog_file=$script_name.$text_dote 

default. backup_device=/dev/rmt0.1 

work_file1 =/tmp/$script_nome.$text_date.work1 

work_file2=/tmp/$script_nome.$text_dote.work2 

config„file=/etc/fscpbktob 

audit_file=/etc/fscpbktab.Qudit 

lock_f ile=/ vor/locks/ f scpbktob 



FIG. 13C 



I Function: show_usage 

j|f Description: Displays connmand usage syntax ond exits 
1 Input: None 

I Output: Usage nnessage to stondord error 
I Return Value: 2 

I Note: This function does not return. It completely exits. 



show_usoge () 



print 


-u2 


n 


print 


-u2 


ft 


prini 


-u2 


n 


prini 


-u2 


n 


prinI 


-u2 


(1 


prini 


-u2 


n 


prini 


-u2 


ft 


prini 


-u2 


ft 


print 


-u2 


ft 


exit 


2 





Usage: fscpbk_nnerge.ksh [-1 directory] [-r doys] 

M 

I 

-I directory Log output directory" 
Defoult is" $defoult_log_dir 

fi 

-r days Log retention period." 

Default is" $retain_days 



I 

§ Korn Shell Settings 

I 

I 

jjfset -0 errexit § Turn on error trapping ond error exit nnode 
jjfset -0 noclobber # Prevent overwriting of existing files 
|set -0 noexec # Perfornn syntax checking without execution 
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#set -0 nolog § Prevents storing function defs in history file 

|set -0 xtroce | Turn on debug mode 

1 

§ Main Routine 

I 

I 

§ Test for cny possed poromoters. 

#if [ $? != 0 ] 

Ithen 

I show_ usage 
# 

log_dir=$default_log_dir 

§ Parse Cannnnand Line Arguments into Variables 

while getopts l:r# c 

do 

cose $c in 

I) § Set up the -I flag 
l_flag=1 

log_dir=$OPTARG;: 
r) § Set up the -r flag 
r_flog=1 

in_retain_doys=$OPTARG;; 
:) show_usage;; 
\?) show„usage;; 
esac 

done 

shift S((0PTIND-1)) FIG. 1 3D 

§ Deal with invocation errors 
if [[ $user_ld != root ]]; then 
show_usage fi 



jfj Configure Logging 

if [[ SLflog -eq 1 ]]; then 

log_f i!e= Sin_ log_dir/$def ault_ log_ file 

nnkdir -p $in_log_dir 2>/dev/null jffCreate new log directory 

else 

log_file=Sdefault_log_dir/$default_log_file 

nnkdir -p $default_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 

retain^ days=$in_ retain_ days 
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§ Clear old logs 

find $log_dir -nome "$script_name»" -mtime $retain_days -exec rm 
§ Creole new log file 

exec 3>> $loq_file j} Open log file for writing 



pr 

pri 
pri 
pri 
pri 

pr 
pr 
pr 
pr 



-u3 "\n= = ======== = ===== ======== = 

-7 n » 

-u3 "= Systems Moncgennent Transaction Log 

-u3 "= Greeted by script:" $script_nanne 
-u3 "= on system:" $(hostname) 

-u3 "= at :" $(date) 

-u3 " = ==== === = === = === = = = = = ==== = 



§ Perform Work 

§ Comments: NOTE!!: This script is on excerpt of the fscpbk_back.ksh 

§ script. If that script is edited, this one 

§ should probobly be edited to motch. 



If Test for existing toble file 
if [[ I (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found." 

print -u3 "Fatal Table error. Table file" $config_file "not found." 

exec 3<&- 

exit 99 

fi 



§ Test for existing table audit file 
if [[ ! (-r $audit_file) ]]; then 

print -u2 "Fatal Table error. Table file check program must be run." 

print -u3 "Fatal Table error. Table audit file" $audit_file "not found." 

exec 3<&- 

exit 97 

fi 

§ Test for table file oudit indicating syntax check since lost edit 



current_Y=$(date +%Y) 



audit_stamp=S( head -1 Saudit_file | awk'j print $1 j') 

§ Check for colon and thus time instead of year on file dotestomp 
ntest=$(ls -I $confiq_file | awk'j print $8 (' | grep : | wc -I) 
if [[ Sntest -eq 1 ]]; then 
edit_year=$current_Y 



FIG. 1 3E 
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else 



edit_year=:$(ls -I $config_file | awk print $8 }') 

fi 



edit_month_text=$(ls -! $config_file | awk '{ print $6 I) 
edit_day=$(ls -I $config_file | awk '| print $7 |' 
edit_hour=$(ls -I $config_file | awk '| print $8 j' | cut -f 1 -d :) 
edit_minute=$(ls -I $config_file | awk ') print $8 |' | cut -f 2 -d :) 

§ Determine month number from month nome 

case $edit_month_text in 

Jan) edit_month=01;; 

Feb) edit_month=02;; 

Mar) edit_month=03;; 

Apr) edit_month=04;; 

May) edit_month=05;; 

Jun) edit„month=06;; 

Jul) edit_month=07;; 

Aug) edit_month=08;; 

Sep) edit_month=09;; 

Oct) edit_month=10;; 

Nov) edit_month=1 1;; 

Dec) edit_month= 1 2;; 

*) print -u2 "Fatal Table error. Table file dote read error." 
print -u3 "Fotal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 



edit_stomp=$edit_year$edit_month$edit_day$edit_hour$edit_minute 

§ Test for table file audited since lost editing 
if [[ $audit_stamp -le $edit_stamp ]]; then 

print -u2 "Fotal Toble error. Table file edited since lost checked" 

print -u3 "Fatal Table error. Table file edited since last checked." 

exec 5<&- 

exit 97 

fi 



§ Table file format 

I Format: bc:pfs:plv:c:afs:alv 

§ xb:/home:hd1 :2:/alt/home:/altlvh 



esac 



FIG. 1 3F 
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ncrement=0 

return_code=0 

merge_return_code=0 

§ Cycle through filesystems and perform merges 
for fs_line in $(cot $config_file | grep -v 
do 

action=$(print $fs_line | cut -f 1 -d :) 
fs_prime=$(print Sfs_line | cut -f 2 -d :) 
lv_prime=$(print $fs_line | cut -f 3 -d :) 
fs_alt=$(print $fs_line | cut -f 5 -d :) 
lv„alt=$(print $fs_line | cut -f 6 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
ta rget_ f s =$f s_ prime 

print -u3 Soction $fs_prime $lv_prime $copies 
if [[ Section != no ]]; then 

§ Merge split filesystems if mirrored 
if [[ Scopies -gt 1 ]]; then 

merge_fs_copy.ksh -p $fs_prime -s $fs_Qlt 
merge_return_code=$merge_return_code+$? 

fi 

fi 

done 



exec 3<&- 

§ Test for unsuccessful filesystem merges 
if [[ $merge_ return. code -ne 0 ]]; then 
exit 20 

fi 

§ Remove lock on toble file 
rm $lock_file 2>/dev/null 
chmod 644 $config_file 

exit 0 



FIG. 13G 



